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HEC-1  AND  HEC-2  APPLICATIONS  ON  THE  MICROCOMPUTER 


Harry  W.  Dotson*,  M.ASCE 


ABSTRACT 

The  Hydrologic  Engineering  Center  (HEC)  has  developed 
versions  of  the  HEC-1  Flood  Hydrograph  Package  and  the 
HEC-2  Water  Surface  Profiles  programs  for  MS/PC-DOS 
compatible  microcomputers  (PC) .  The  increased  speed, 
memory  and  storage  capacity  of  the  latest  PCs  make  the  use 
of  these  large  FORTRAN  programs  highly  practical  in  the  PC 
environment. 

Typical  tasks  that  are  required  when  using  these  batch 
oriented  programs  include  creating,  checking  and  editing 
input  data;  executing  the  program;  and  summarizing  and 
displaying  the  results.  The  HEC  has  developed  a  menu  driven 
user  interface  or  shell  program  to  integrate  several 
application  programs,  an  editor  and  other  utility  programs 
to  assist  the  user  in  accomplishing  these  tasks.  The 
interface  takes  advantage  of  the  unique  capabilities  and 
user  friendliness  found  in  the  PC  environment.  In  addition 
to  the  HEC-1  and  HEC-2  programs,  the  integrated  package 
includes  a  program  (SUMPO)  for  creating  summary  tables  of 
HEC-2  results,  a  program  ( PL0T2 )  that  plots  cross  sections 
and  water  surface  profiles,  and  a  PC  version  of  the  Corps 
of  Engineers  editor  (COED),  which  features  full  screen 
editing  and  on-line  help  screens  and  documentation.  The 
application  of  these  programs  is  described  and  demonstrated 
using  the  menu  driven  interface. 

INTRODUCTION 

The  Hydrologic  Engineering  Center  (HEC)  has  converted 
several  of  their  engineering  application  programs  to  the 
microcomputer  (PC).  In  order  to  take  advantage  of  the 
unique  capabilities  of  the  PC  and  to  assist  the  user  in 
working  with  these  programs,  the  HEC  has  developed  menu 
driven,  user  interfaces  for  several  of  their  PC  application 
programs.  This  paper  describes  the  use  and  features  of  the 
menu  driven  interfaces  developed  for  the  Flood  Hydrograph 
Package  (HEC-1)  and  the  Water  Surface  Profiles  (HEC-2) 
programs . 
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HEC-1  APPLICATIONS  WITH  MENU1 


The  HEC-1  program  menu  interface  (MENU1)  allows  the 
user  to  define  input  and  output  file  names,  create  and  edit 
input  data  files,  run  the  HEC-1  program  and  display  program 
output  to  the  printer  or  console.  The  opening  menu  screen 
for  MENU1,  listing  these  choices,  is  shown  on  Figure  1. 

«  ME(!1  I'Ath****  Hirnii  I 


1  Define  I npu t 'Du t pti t  tiles 
7  Crtta  tf /fc<l  i  t  Input  file 


4  Display  Output  to  tmisole 
!» .  Chit  to  Doit 


input 


(specify)  OUTPUT  f  OH 


F’rcitS  uuwher  of  desired  option  or  t  i  with  <EHTER) 


Figure  1.  MENU1  Opening  Screen 

Menu  options  shown  are  selected  either  by  using  the 
cursor  keys  or  by  simply  entering  the  number  of  the 
selection  desired.  The  first  choice  on  the  menu  allows  the 
user  to  define  input  and  output  file  names.  If  this  choice 
is  selected  a  window  appears  on  the  screen  so  that  the  user 
can  type  in  the  names  of  the  input  and  output  files.  An 
alternative  to  typing  in  the  names  is  to  enter  a  guestion 
mark  (?)  and  a  directory  of  file  names  in  the  current 
directory  will  appear  in  a  window  on  the  sc  een.  The  user 
can  then  select  from  this  directory  of  file  names  by  using 
the  cursor  keys.  The  second  choice  on  the  r.«*nu  allows  the 
user  to  create  a  new  or  edit  an  existing  inj  it  data  file 
using  the  Corps  of  Engineers  editor  (COED).  COED  has  been 
modified  by  HEC  so  that  it  will  perform  not  only  as  a 
powerful  line  editor  but  a  full  s<  rcen  editor  as  well.  COED 
also  includes  extensive,  easy  to  u.e  on-line  locumentat ion . 
Additional  enhancements  have-  also  been  add*  d  to  allow  right 
justified  data  entry  in  10-8  column  fields  and  program 
specific  variable  identification  and  deser i pt i on .  This 
latter  capability  will  be  discussed  in  a  subsequent 
section.  The  third  chonc  on  the  menu  i..  to  run  the  HEC-1 
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the  HEC-1  program  has  finished  execution,  the  user  is 
returned  to  the  menu.  The  fourth  choice  on  the  menu  allows 
the  user  to  display  the  HEC-1  program  output  file  on  the 
screen  or  send  the  output  to  the  printer.  This  choice  is 
made  by  pressing  the  space  bar  to  toggle  between  the 
console  and  the  printer.  A  utility  program  is  used  to 
display  the  output  (or  any  file  specified)  to  the  screen 
and  allows  scrolling  up  and  down,  right  and  left,  searching 
and  many  other  features.  A  program  called  PROUT  is  used  to 
send  output  to  the  printer  with  carriage  control 
recognition.  The  last  choice  on  the  menu  returns  the  user 
to  DOS. 

DATA  ENTRY  AND  EDITING  USING  COED 

A  special  feature  has  been  added  to  the  COED  program 
that  assists  the  user  in  preparing  input  data  for  specific 
HEC  application  programs.  This  feature  includes  variable 
name  and  field  location  prompting,  automatic  tab  stops  and 
right  justification  of  input  for  each  variable  field, 
checking  for  inappropriate  (non-numeric)  data  entry  where 
applicable,  and  cursor  position  sensitive  input  variable 
definitions.  These  features  are  invoked  while  in  the  full 
screen  mode  by  entering  the  Help  Program  command  and  the 
name  of  the  program  for  which  the  input  data  applies.  When 
the  cursor  is  placed  on  a  line  having  a  two  character 
record  ID  in  the  first  two  columns,  the  name  of  the 
variables  for  that  record  are  shown  in  their  appropriate 
position  at  the  bottom  of  the  screen.  When  the  cursor  is 
on  a  variable  position  and  the  Help  Variable  command  is 
issued,  the  definition  of  that  variable  appears  in  a  window 
on  the  screen.  Figure  2  illustrates  this  feature  for  the 
variable  ITIME  in  field  three  of  the  IT  record  for  the 
HEC-1  program. 
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Figure  2.  COED  Help  Program  and  Help  Variable  Feature 
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HEC-2  APPLICATIONS  USING  MENU 2 


MENU 2  is  the  menu  driven  user  interface  that  assists 
the  user  when  making  HEC-2  program  applications.  MENU2  is 
similar  to  the  MENU1  interface  described  previously.  It 
allows  the  user  to  define  input  and  output  tiles,  create 
and  edit  input  data  files,  and  display  the  results.  The 
MENU2  package  also  uses  COED  and  its  associated  Help 
Program  and  Help  Variable  capabilities  specifically 
designed  for  the  HEC-2  program.  In  addition,  MENU2 
interfaces  three  supplementary  programs,  called  EDIT2 , 
SUMPO,  and  PL0T2  that  can  be  used  with  the  HEC-2  program  to 
check  input  data,  create  summary  tables  from  HEC-2  results, 
and  plot  cross  sections  and  water  surface  profiles, 
respectively.  The  space  bar  is  used  from  nenu  item  three 
to  toggle  the  selection  of  the  HEC-2  program  or  any  oi 
these  three  supplemental  programs.  Each  of  these 
additional  features  are  described  in  the  following 
paragraphs. 

CHECKING  HEC-2  INPUT  DATA  USING  EDIT2 

The  EDIT2  program  allows  the  user  to  check  HEC-2 
program  input  data  for  errors  prior  to  execution.  The 
program  uses  the  HEC-2  input  data  file  as  its  input  and 
checks  the  entire  file  for  fatal  errors,  as  well  as 
possible  errors  and  inconsistencies.  The  optional  ED 
record  can  be  specified  as  the  first  record  in  the  input  to 
set  EDIT2  program  options  for  listing  input,  output  format, 
and  change  the  range  of  elevation  differences  that  the 
program  checks  for  in  the  cross-sectional  data.  An  input 
listing,  if  not  suppressed,  and  error  messages  are  written 
to  the  specified  output  file.  After  the  results  of  the 
EDIT2  run  are  reviewed,  COED  can  be  used  to  correct  the 
HEC-2  input  data  prior  to  execution. 

CREATING  SUMMARY  TABLES  OF  HEC-2  RESULTS  USING  SUMPO 

The  SUMPO  program  is  used  to  create  conve  iient  summary 
tables  using  the  computed  results  from  HEC-2  multiple  water 
surface  profile  runs.  The  user  first  runs  the  HEC-2 
program,  which  creates  a  binary  file  of  results.  This 
binary  file  becomes  the  input  file  for  the  SUMPO  program. 
The  SUMPO  program  menus,  which  are  similar  to  those 
described  for  MENU2,  can  be  used  to  select  standard, 
predefined  summary  tables  or  to  create  user  defined  summary 
tables  by  selecting  the  variables  to  be  displayed.  User 
selected  summary  table  variable  lists  can  be  stored  for 
later  use.  The  screen  including  a  window  for  selecting 
standard  summary  tables,  which  appears  after  selecting 
choice  2  from  the  opening  SUMPO  menu,  is  hown  on  Figure  3. 
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Figure  3 .  SUMPO  Standard  Summary  Table  Selection  Menu 
PLOTTING  CROSS  SECTIONS  AND  PROFILES  USING  PLOT2 

Graphical  interpretations  of  cross-sectional  data  and 
water  surface  profile  computations  are  an  effective  way  of 
reviewing  HEC-2  program  input  and  results.  The  PLOT2 
program  provides  the  capability  of  creating  plots  of 
cross  sections  from  the  HEC-2  program  input  and  profiles  of 
water  surface  elevation  or  any  of  the  other  variables 
available  from  HEC-2  program  results  written  to  the  binary 
file.  The  plots  are  created  by  using  a  series  of  menus 
similar  to  those  described  for  MENU 2  and  SUMPO.  The 
opening  menu  for  PL0T2  present  a  choice  of  plotting 
profiles,  plotting  cross  sections  or  exiting  the  program. 
If  plot  profiles  is  selected,  a  second  menu  appears  giving 
the  user  the  choice  of  defining  profile  options,  defining 
plotting  options,  plotting  the  profile  or  returning  to  the 
main  menu.  This  Plot  Profiles  Menu  also  allows  the  user  to 
specify  the  names  of  the  HEC-2  program  input  and  binary 
files.  If  define  profile  options  is  selected,  an 
additional  menu  is  displayed.  This  menu  allows  the  user  to 
select  the  variable  to  be  plotted,  whether  the  invert 
profile  is  to  be  plotted,  and  the  starting  and  ending 
cross  section  for  the  profile  to  be  plotted.  If  the  user 
selects  the  define  plotting  options  choice  from  the  Plot 
Profiles  Menu,  a  menu  is  displayed  that  allows  the 
definition  of  labels  and  legends,  and  specification  of  the 
plotting  device  to  be  used.  Device  choices  are  the  color 
graphics  adapter,  the  enhanced  graphics  adapter,  or  the  HP 
7475  pen  plotter.  Once  the  desired  profile  and  plotting 
options  have  been  selected,  the  user  can  select  the  begin 
plotting  option  from  the  Plot  Profiles  Menu  to  plot  the 
defined  profile. 


The  procedure  for  plotting  cross  sections  is  similar 
to  that  described  for  plotting  profiles.  Choice  2,  plot 
cross-sections  is  selected  from  the  PL0T2  opening  menu.  A 
second  menu  appears  for  defining  cross-section  and  plotting 
options  and  specifying  file  names.  The  cross  section 
options  consist  of  whether  to  plot  water  surface,  bridge 
geometry,  n-values,  encroachments  or  channel  improvements 
on  the  cross  section.  The  plotting  option  selection  is  for 
defining  plot  labels,  grid  and  plotting  device.  An  example 
cross-section  plot  is  shown  on  Figure  4. 
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Figure  4.  Example  Cross-Section  Plot  Usjng  PL0T2 
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Urban  Watershed,  J.  Abbott, 

Oct  78,  53  pp. 

Operational  Simulation  of  a  Reservoir 
System  with  Pumped  Storage, 

G.  F.  McMahon,  V.  R.  Bonner  and 
B.  S.  Eichert,  Feb  79,  32  pp. 

Technical  Factors  in  Small  Hydropower 
Planning  D.  W.  Davis,  Feb  79, 

35  pp. 

Flood  Hydrograph  and  Peak  Flow  Frequency 

Analysis,  A.  D.  Feldman,  Mar  79  21  pp. 

HEC  Contribution  to  Reservoir  System 
Operation,  B.  S.  Eichert  and 
V.  R.  Bonner,  Aug  79,  28  pp. 

Determining  Peak-Discharge  Frequencies  in 

an  Urbanizing  Watershed:  A  Case  Study, 

S.  F  Daly  and  J.  C.  Peters,  Jul  79,  15  pp. 

Feasibility  Analysis  in  Small  Hydropower 

Planning,  D.  W.  Davis  and  B.  W.  Smith, 

Aug  79,  20  pp. 

Reservoir  Storage  Determination  by  Computer 
Simulation  of  Flood  Control  and 
Conser\ ation  Systems,  B.  S.  Eichert, 

Oct  79,  10  pp. 

Hydrologic  Land  Use  Classification  Using 
LANDS AT,  r.  J.  Cerraak,  A.  D.  Feldman 
and  R.  P.  Webb,  Oct  79,  26  pp. 

Interactive  Nonstt uctural  Flood-Control 
Plannng,  D.  T.  Ford,  Jun  80,  12  pp. 


NT  IS 
NUMBER 


)-A106  258 


-A106  259 


1-A109  757 


-A109  758 


3-A109  759 


J-A109  760 


1-A109  761 


-A109  762 


-A109  763 


5-A109  764 


HEC 

HUMBER 

TP-69 

TP- 70 

TP- 71 

TP-72 

TP-73 

TP-74 

TP-75 

TP- 7  6 

TP-77 

TP-78 


TECHNICAL  PAPERS  (TP)( Cont inued ) 


TITLE 


hec  trris 

PRICE  NUMBER 


tZ.OO  Each 


Critical  Water  Surface  by  Minimum  Specific 
Energy  Using  the  Parabolic  Method, 

B.  S.  Eichert,  1981,  15  pp. 

Corps  of  Engineers  Experience  with 
Automatic  Calibration  of  a 
Precipitation-Runoff  Model,  D.  T.  Ford, 

E.  C.  Morris,  and  A.  D.  Feldman, 

May  80,  12  pp. 

Determination  of  Land  Use  from  Satellite 

Imagery  for  Input  to  Hydrologic  Models, 

R.  P.  Webb,  R.  Cermak,  and  A.  D.  Feldman, 
Apr  80,  18  pp. 

Application  of  the  Finite  Element  Method  to 
Vertically  Stratified  Hydrodynamic  Flow 
and  Water  Quality,  R.  C.  MacArthur  and 
W.  R.  Morton,  May  80,  12  pp. 

Flood  Mitigation  Planning  Using  HEC-SAM, 

D.  W.  Davis,  Jun  80,  17  pp. 

Hydrographs  by  Single  Linear  Reservoir 

Model,  J.  T.  Pederson,  J.  C.  Peters, 
and  0.  J.  Helweg,  May  80,  17  pp. 

HEC  Activities  in  Reservoir  Analysis, 

V.  R.  Bonner,  Jun  80,  10  pp. 

Institutional  Support  of  Water  Resource 
Models,  J.  C.  Peters,  May  80,  23  pp. 

Investigation  of  Soil  Conservation  Service 
Urban  Hydrology  Techniques, 

D.  G.  Altman,  W.  H.  Espey,  Jr.  and 
A.  D.  Feldman,  May  80,  14  pp. 

Potential  for  Increasing  the  Output  of 
Existing  Hydroelectric  Plants, 

D.  W.  Davis  and  J.  J.  Buckley, 

Jun  81,  20  pp. 


AD-A951  599 

AD-A109  765 

AD-A109  766 

AD-A109  767 

AD-A109  756 

AD-A109  768 

AD-A109  769 

AD-A109  770 

AD-A109  771 

AD-A109  772 


3 


HEC 

HUMBER 

TP- 7  9 

TP-80 

TP-81 

TP-82 

TP-83 

TP-84 

TP-85 

TP  36 

TP-87 

TP-88 

TP-89 


TCCh >UCAL  PfU'ERS  up)  ( Continued ) 


TITLE 


HEC  NT IS 

PRICE  NUMBER 


<2.00  Each 


Potential  Energy  and  Capacity  Gains  from 
Flood  Control  Storage  Reallocation 
at  Existing  U.  S.  Hydropower 
Reservoirs,  B.  S.  Eichert  and 

V.  R.  Bonner,  Jun  81,  18  pp. 

Use  of  Non-Sequential  Techniques  in  the 

Analysis  of  Power  Potential  at  Storage 
Projects,  G.  M.  Franc,  Jun  81,  18  pp. 

Data  Managenu  nt  Systems  for  Water  Resources 
Planning,  D.  W.  Davis,  Aug  81,  12  pp. 

The  New  HEC-1  Flood  Hydrograph  Package,  A.  D. 
Feldman,  P.  B.  Ely  and  D.  M.  Goldman, 

May  81,  28  pp. 

River  and  Reservoir  Systems  Water  Quality 
Modeling  Capability,  R.  G.  Willey, 

Apr  82,  15  pp. 

Generalized  Real-Time  Flood  Control  System 
Model,  B.  S.  Eichert  and  A.  F.  Pabst, 
Apr  82,  18  pp. 

Operation  Policy  Analysis:  Sam  Rayburn 
Reservoir,  D.  T.  Ford,  R.  Garland 
and  C.  Sullivan,  Oct  81,  16  pp. 

Training  the  Practitioner:  The  Hydrologic 
En^ia  i'jring  Center  Progr  am, 

W.  K.  Tohnson,  Oct  81,  20  pp. 

Documentation  Needs  for  Water  Resources 

Models,  W.  K.  Johnson,  Aug  82,  16  pp. 

Reservoir  System  Regulation  for  Water 
Quality  Control,  R.G.  Willey, 

Mar  83,  18  pp. 

A  Software  System  to  Aid  in  Making  Real-Time 
Water  Control  Decisions,  A.  F.  Pabst 
and  J.  C.  Peters,  Sep  83,  17  pp. 


AD-A109  787 

AD-A109  788 

AD-A114  650 

AD-A114  360 

AD-A114  192 

AD-A114  359 

AD-A123  526 

AD-A123  568 

AD-A123  558 

AD-A130  829 


AD-A138  616 


TECHNICAL  PAPERS  ( TP H Continued) 


KEC 

HUMBER 

TP-90 

TP-91 

TP-92 

TP-93 

TP-94 

TP-95 

TP-96 

TP-97 

TP-98 

TP-99 


TITLE 


KEC  HTIS 

PRICE  HUMBER 

$2.00  Each 


Calibration,  Verification  and  Application 
of  a  Two-Dimensional  Plow  Model, 

D.  M.  Gee,  Sep  83,  6  pp. 

HEC  Software  Development  and  Support, 

B.  S.  Eichert,  Nov  83,  12  pp. 

Hydrologic  Engineering  Center 
Planning  Models 
D.  T.  Ford  and  D.  W.  Davis, 

Dec  83,  17  pp. 

Flood  Routing  Through  a  Flat,  Complex 
Floodplain  Using  A  One-Dimensional 
Unsteady  Flow  Computer  Program, 

J.  C.  Peters,  Dec  83,  8  pp. 

Dredged-Material  Disposal  Management 
Model,  D.  T.  Ford,  Jan  84,  18  pp. 


AD-A135  666 

AD-A139  009 

AD-A139  010 

AD-A139  Oil 

AD-A139  008 


Infiltration  and  Soil  Moisture  Redistribution  AD-A141  626 

in  HEC-1 ,  A.  D.  Feldman,  Jan  84, 


The  Hydrologic  Engineering  Center  Experience  AD-A141  860 

in  Honstructural  Planning,  W.  K.  Johnson 
and  D.  W.  Davis,  Feb  84,  7  pp. 


Prediction  of  the  Effects  of  a  Flood  Control  AD-A141  951 

Project  on  a  Meandering  Stream, 

D.  M.  Gee,  Mar  84,  12  pp. 


Evolution  in  Computer  Programs  Causes  Evolution  AD-A145  601 

in  Training  Heeds:  The  Hydrologic 
Engineering  Center  Experience,  V.  R.  Bonner, 

Jul  84,  20  pp. 

Reservoir  System  Analysis  for  Water  Quality,  AD-A145  680 

J.  H.  Duke,  D.  J.  Smith  and  R.  G.  Willey, 

Aug  64,  27  pp. 
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TECHNICAL  PAPERS  (TP) (Continued) 


HEC 

HUMBER 


TITLE 


HEC 

PRICE 


NT  IS 

HUMBER 


\2 .00  Each 


TP-100  Probable  Maximum  Flood  Estimation  -  Eastern  AD-A146  536 

United  States,  P.  B.  Ely  and  J.  C.  Peters, 

Jun  84,  5  pp. 


TP-101  Use  of  Computer  Program  HEC-5  For  Water  AD-A146  535 

Supply  <inalysis,  R.  J.  Hayes  and 
Bill  S.  Eichert,  Aug  84,  7  pp. 


TP-102  Role  of  Calibration  in  the  Application  of  HEC-6  AD-A149  269 

of  HEC-£ ,  D.  Michael  Gee,  Dec  84,  19  pp. 


TP-103  Engineering  ind  Economic  Considerations  in  A150  154 

Formulating  Nonstructural  Plans, 

M.  W.  Burnham,  Jan  85,  16  pp. 

TP-104  Modeling  Water  Resources  Systems  for  Water  AD-A154  288 

Quality,  R.  G.  Willey,  D.  J.  Smith  and 
J.  H.  Duke,  Feb  85,  10  pp. 

TP-105  Use  of  a  Two-Dimensional  Flow  Model  to  AD-A154  287 

Quantify  Aquatic  Habitat,  D.  M.  Gee 
and  D.  B.  Wilcox,  Apr  85,  10  pp. 

TP-106  Flood-Runoff  Forecasting  with  HEC1F,  J.  C.  Peters  AD-A154  286 
and  P.  B.  ELy,  May  85,  7  pp . 

TP-107  Dredged-Materiai  Disposal  System  Capacity  AD-A171  090 

Expansion,  D.  T.  Fcrd,  Aug  85,  23  pp. 

TP-108  Role  of  Small  Computers  in  Two-Dimensional  AD  159  666 

flow  Modeling,  D.  M  Gee,  Oct  85,  6  pp . 

TP  109  One  Dimensional  Model  for  Mud  Flows,  AD-159  921 

D.  R  Chamber,  and  R  C.  Mac Arthur, 

Oct  h‘>,  6  pp . 

TP-110  Subdivision  Froude  Number,  David  H.  Schoe 1 lhamer ,  AD  AlfaO  486 
John  C.  Peters,  and  Bruce  E.  Larock, 

O'  t  8  5  ,  6 

TP-111  HEC-5Q:  System  Water  Quality  Modeling,  AD-  16  4  832 

R.  G.  Willey,  Jan  B6 ,  13  pp 

TP-112  Hew  Developments  in  HEC  Programs  for  Flood  AD  A172  495 

Control,  V.  R.  Conner ,  Aug  B6 ,  18  pp 

TP-113  Modeling  and  Managing  Water  Resource  Systems  Al)- A 1  7  706  5 

fcr  Watei  Quality,  R  G  Willey,  Jan  86, 


* 


TP-114 


Accuracy  of  Coapulod  Itotor  Surface  Profiles 
(Executive  Suntry),  H.  U.  Bum  has  and 
D.  U.  Davie,  Dec  86,  24  pp. 


AD-A1 76334 


TP-115 


Application  of  Spatial-Data  Manage 
ques  In  Corps  Planning,  D.  W. 
D.  T.  Ford,  Dec  86,  14  pp. 


tent  Technl- 
Devls  and 


AD-A 176300 


TP-116 


The  Hydrologic  Engineering  Center’s  Activities 
in  Watershed  Modeling,  Gary  W.  Brunner,  July  87, 
14  pp. 
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